Dynamic Pie Chart
Widget size: 1 x 1, 2 x 1, 2 x 2, 3 x 3, 4 x 4
This widget displays the last value, or an aggregation value (Sum, Avg, Max, Min) for a point or series of points.
Click on any of the pie chart segments and the widget will drilldown to an Engineering Chart of data for the point(s), or maximise the widget to fit the screen, or explode a segment of the pie (depending upon widget configuration).
Clicking the maximise icon at the top right of the widget will also maximise the widget to fit the screen.
Customisation
Widget Configuration – The following configuration affects the whole widget.
| Value | Default | Comment |
|---|---|---|
| Widget Heading | Dynamic Pie Chart | Enter the name of the widget as it is to appear in the heading. |
| Exploded | No | Select Yes to see a segment of the pie chart exploded by default. |
| Period Selection | Dashboard / Period Selector | If Dashboard/Report Selector is selected, then the values of each segment in the pie relate to the period specified in the dashboard period selector, aggregated as per the "Data Aggregation" setting. The 2nd option is Last Values. If this is selected then the last value of each point(s) (regardless of dashboard period selector) is aggregated as per the "Data Aggregation" setting. Which points are included in these aggregations will be dependent upon the site/container selected in the dashboard navigation tree. |
| Data Aggregation | Sum | If the "Period Selection" is set to Dashboard/Period Selector then the "Data Aggregation" gives either a Sum, Average, Maximum, Minimum, or Last Value for the period specified in the Dashboard Period Selector, for all points configured in each row (segment). If the "Period Selection" is set to Last Values then the "Data Aggregation" gives either a Sum, Average, Maximum, Minimum, or Last Value regardless of the dashboard period selector, for all points configured in each row (segment). If a single row (segment) has points that span multiple sites, then choosing a "Data Aggregation" of Last Value will give an average of the last values of the points configured for that row. The last values used will either be the last values for the period (if "Period Selection"=Dashboard/Report Selector), or the last value from all the point data (if "Period Selection"=Last Values). Which points are included in these aggregations will be dependent upon the container selected in the dashboard navigation tree. |
| Refresh Period | 0 | Select a refresh period from the drop down menu, from between 15 sec to 1 hr, or no refresh at all. |
| Show Info | No | Select Yes to show period and aggregation information in the top-right of the widget. |
| Legend Layout | Horizontal | Alignment of the legend is Horizontal or Vertical. |
| Legend Position | Top-Centre | The legend can be aligned in various positions according to the options in the drop down. |
| Legend Options | Name | Name only, Data value only, or Both name and data value. |
| Segment Options | Name | Name only, Data value only, or Both name and data value. |
| 3D Settings | 30,15 | Angle, Depth. The default is 30,15. Angle accepts values 0-80. 0 is a flat chart. Values outside this range will default to nearest value in range. Depth accepts values 0-100. 0 is a flat chart again but this may still be shown at an angle. Values outside this range would default to nearest value in range. |
| Show Total | False | Select True to see the total for the selected period. |
| Display All Org Sites | False | False - Display data on the widget based upon the site selection from the dashboard navigation treeview. True - Ignore any site selection from the treeview, and always display data from all sites within the organisation. |
| Drilldown Target | popup | Pop up - Drilldown will show in a Pop up modal window New Window - Drilldown will show in a new browser tab/window. |
| Ignore Zeros | True | If false then the pie chart will show data with a value of zero in the legend and on the segment. |
Row Configuration - The following configuration is done on an individual row (pie segment) basis. Each row can be set independently of another.
| Label | [PointName] | If left blank, and there is more than one point configured per row, then only the first point name is chosen. A label can be used to override the point name |
|---|---|---|
| Segment Colour | Default | If no colours are chosen by the user then they default to a standard palette of colours. This palette is configured within Web Config under the "Dynamic Chart Theme" setting. Colours can be described in several ways: The standard way is for a colour to be described in a hexadecimal format, e.g. #00FF00. Colours can additionally be described in an RGB format, e.g. rgb(0,255,0) Opacity can be introduced using the RGBA syntax as a fourth parameter, e.g. rgba(0,255,0,1). The last parameter is the opacity that ranges from 0 (fully transparent) to 1 (fully opaque). Additionally, colours can be described as 'red', 'tan' - these are standard CSS Colour Names. Any colour that is entered as invalid will be displayed as black. |
| Number Format | 0.## | The number format can be written as a mask: 0 (Digit) # (Digit, zero shows as absent) . (The position of the decimal point Example: ###.##) , (The group separator for thousands. Example: ###,###.##) % (Displays the number as a percentage. Example: ##%) ; (Pattern separator. The first pattern will be used for positive numbers and the second for negative numbers) |
| Drilldown | Engineering Chart | Choose between a drilldown to Engineering Chart, a drilldown to a dashboard, a drilldown to a report, or no drilldown at all |
| Dashboard List | blank | A list of all the dashboards the user has access to. |
| Reports List | blank | A list of all the reports the user has access to. |
Row 1 – Row 12. Each row corresponds to an individual pie segment.
Click the plus icon to add additional rows.
Enter PointIDs of points to appear as segments of the pie.
Points over multiple sites can be configured, and the pie will update as each site/container is selected by the dashboard navigation treeview. For multi-site configuration, unless the points per row share the same point names, then using a custom "Label" for each row would be required.